ODk Test Framework (версия 2.4.1)/io.bitbucket.dsmoons.framework.odk.wrappers/Element

Element

open class Element(var browser: Browser, var elementHelper: ElementHelper)

Класс предоставляет методы взаимодействия с элементами на странице браузера. Экземпляры класса создаются методами PageBase.getElementByXpath, PageBase.getElementByClassName и другими методами getElementBy... класса PageBase

Constructors

Element

constructor(element: Element)

Конструктор для создания пользовательских классов элементов.

internal constructor(browser: Browser, elementHelper: ElementHelper)

Types

Select

class Select(val browser: Browser, val elementHelper: ElementHelper, val element: Element)

Внутренний класс с методами работы с тегом select.

Properties

browser

internal var browser: Browser

elementHelper

internal var elementHelper: ElementHelper

Functions

assertAndAccumulateThat

fun assertAndAccumulateThat(func: Function<Element, Boolean>, errorMessage: String): Element

fun assertAndAccumulateThat(func: Function<Element, Boolean>, description: String, errorMessage: String): Element

Проверка истинности условия. Если условие ложно, то вызывается исключение, логируется сообщение об ошибке, но тест не останавливается.

assertThat

fun assertThat(func: Function<Element, Boolean>, errorMessage: String): Element

fun assertThat(func: Function<Element, Boolean>, description: String, errorMessage: String): Element

Проверка истинности условия. Если условие ложно, то вызывается исключение, логируется сообщение об ошибке, тест останавливается.

checkExists

private fun checkExists(message: String): Boolean

clear

fun clear(): Element

Очистка элемента (удаление текста из текстового поля, области текста и т.д.)

clearElementState

@JvmOverloads

fun clearElementState(clearParents: Boolean = false): Element

Очистка кэша элемента. Следующее обращение к элементу начнется с его поиска.

click

@JvmOverloads

fun click(withJS: Boolean = false): Element

Клик по элементу

count

fun count(): Int

Количество элементов с таким локатором

doubleClick

fun doubleClick(): Element

Двойной клик по элементу

dragAndDropTo

fun dragAndDropTo(element: Element): Element

Перетягивание этого элемента на переданный элемент.

exists

fun exists(): Boolean

Проверка наличия элемента. Возвращает true, если элемент найден.

getAttribute

fun getAttribute(attribute: String): String

Получение значения атрибута элемента

getCssValue

fun getCssValue(propertyName: String): String

Получение значения css-свойства элемента

getDomAttribute

fun getDomAttribute(attribute: String): String

Получение значения Dom-атрибута элемента

getDomProperty

fun getDomProperty(property: String): String

Получение значения Dom-свойства элемента

getInnerHtml

fun getInnerHtml(): String

Получение html-разметки элемента

getLocation

fun getLocation(): Point

Получение координат элемента

getRectangle

fun getRectangle(): Rectangle

Получение размеров и координат элемента

getSelect

fun getSelect(): Element.Select

Возвращает объект с методами взаимодействия с тегом Select.

getSize

fun getSize(): Dimension

Получение размеров элемента

getTagName

fun getTagName(): String

Получение имени тега элемента

getText

fun getText(): String

Получение текста элемента

ifExists

fun ifExists(consumer: Consumer<Element>): Element

Если элемент присутствует на странице, метод выполняет переданные действия (consumer) над элементом

isDisplayed

fun isDisplayed(): Boolean

Получение значения свойства displayed элемента

isEnabled

fun isEnabled(): Boolean

Получение значения свойства enabled элемента

isHidden

fun isHidden(): Boolean

Метод возвращает признак скрытости элемента

notExists

fun notExists(): Boolean

Проверка отсутствия элемента. Возвращает true, если элемент не найден.

removeAttribute

fun removeAttribute(attribute: String): Element

Удаление атрибута элемента

rightClick

fun rightClick(): Element

Клик правой кнопкой мыши по элементу

scrollToBottom

fun scrollToBottom(): Element

Прокрутка элемента к низу экрана

scrollToCenter

fun scrollToCenter(): Element

Прокрутка элемента к центру экрана

scrollToTop

fun scrollToTop(): Element

Прокрутка элемента к верху экрана

sendKeys

@JvmOverloads

fun sendKeys(message: CharSequence, clear: Boolean = false): Element

Отправка сообщения в элемент.

sendPassword

fun sendPassword(password: String): Element

Отправка пароля в элемент.

setAttribute

fun setAttribute(attributeName: String, attributeValue: String): Element

Установка атрибута элементу

setCssValue

fun setCssValue(propertyName: String, propertyValue: String): Element

Установка css-свойства элементу

setValue

fun setValue(message: String): Element

Отправка сообщения в элемент.

submit

fun submit(): Element

Отправка формы

takeScreenshot

fun takeScreenshot(): File?

Создание скриншота элемента. Скриншот добавляется в лог и отчет Allure

toList

fun toList(): List<Element>

Метод возвращает список элементов, найденных по локатору данного элемента.

toString

open override fun toString(): String

Описание элемента и его локатор в виде строки

toWebElement

@JvmOverloads

fun toWebElement(timeout: Int = SettingsHelper.webDriverWaitElementTimeoutInSeconds): WebElement?

Получение объекта WebElement. Используется в связке с методом PageBase.performActions

uploadFile

fun uploadFile(vararg files: File): Element

fun uploadFile(vararg files: String): Element

Загрузка одного или нескольких файлов.

waitFor

@JvmOverloads

fun waitFor(func: Function<Element, Boolean>, needFail: Boolean = false, waitingTime: Int? = null, interval: Int = 100): Element

Ожидание выполнения условия для элемента.

waitForExists

@JvmOverloads

fun waitForExists(needFail: Boolean = false, waitingTime: Int? = null): Element

Ожидание наличия элемента на странице.

waitForExistsAnd

@JvmOverloads

fun waitForExistsAnd(func: Function<Element, Boolean>, needFail: Boolean = false, waitingTime: Int? = null, interval: Int = 100): Element

Ожидание наличия элемента на странице и выполнения условия для элемента.